home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / utilities / dfsreader / !DFSreader / !Help < prev    next >
Encoding:
Text File  |  1990-03-30  |  6.7 KB  |  208 lines
  1. !Help for !DFSreader Version 0.01 Beta
  2. --------------------------------------
  3.  
  4. [Docs as of 31-Mar-90]
  5.  
  6. Files included in this package :-
  7.  
  8.   !Run
  9.   !RunImage
  10.   !Sprites
  11.   !Help
  12.   Templates
  13.   MakeTrans
  14.   typetrans
  15.   chkspr    ) my chkspr util, rename the app and see what
  16.   !Boot     ) happens (nothing!). Notes in Comments.
  17.  
  18.  
  19.   This app was designed to aid transfer of DFS files to the
  20. Arc. Of course there are many ways to do this, the cheapest
  21. being serial transfer, notorious for the headaches it
  22. causes. Since I had an external 5.25" drive I wrote this
  23. app to allow me to transer files to & from my BBC with the
  24. minimum of hassle. Of course if you have DFS files on a
  25. 3.5" disc (why?) then the app should function quite
  26. satisfactorally.
  27.  
  28. NOTE
  29. ----
  30.  
  31. This app IS a beta version & many factilitys are missing
  32. from it, for instance it won't read 40 track discs (I
  33. think!), only accepts Acorn DFS discs (or compatible, want
  34. Watford DFS, send me the spec & I will gladly add it!) and
  35. there in no format command. This app is NOT a dfs filer, by
  36. simply a customized sector reader.
  37.  
  38.  
  39. Usage
  40. -----
  41.  
  42.   Double clicking on the !DFSreader icon in the filer
  43. window will install the application on the left hand side
  44. of the iconbar.
  45.  
  46.   Under the !DFSreader icon is a drive number. This number
  47. specifies the drive using the DFS convention, NOT the
  48. standard ADFS convention. ie
  49.  
  50.                Drive  Side  Number
  51.               
  52.                  0     0      :0
  53.                  1     0      :1
  54.                  0     1      :2
  55.                  1     1      :3
  56.  
  57. (this should be no problem to previous DFS users)
  58.  
  59.   To catalogue a DFS disc in the chosen drive simply click
  60. on the DFSreader icon and a filer type window will open
  61. displaying the contents of the disc.
  62.  
  63.   To transfer files to and from a DFS disc simply treat the
  64. DFSreader window as a standard filer window. ie drag icons
  65. to and from save and filer windows to load and save files
  66. onto the DFS disc. Transfers to and from memory resident
  67. applications can take place just as easily although note
  68. that the Wimp <Scrap$File> is used as a temporary store.
  69.  
  70.   To change discs, just insert the new disc and click on
  71. the DFSreader icon. Note : if you change the disc without
  72. clicking on the DFSreader icon then !DFSreader will not
  73. allow you to make any transfers.
  74.  
  75.   The iconbar menu gives you access to certain general
  76. actions :-
  77.  
  78. Info                 Displays current version number &
  79.                      date, please quote this in all
  80.                      corespondence.
  81. Drive (submenu)      Allows section of desired drive.
  82.  
  83. Name Disc (submenu)  Allows the disc name to be changed.
  84.  
  85. Import Dir           If ticked then the DFS directory
  86.                      character prefix (except $) is placed
  87.                      at the front of the ADFS file name.
  88.  
  89. Free                 Displays the free space on the disc.
  90.  
  91. Quit                 Removes the !DFSreader application
  92.                      from memory.
  93.  
  94.   There is also a context sensitive menu for the file
  95. window which when menu is clicked offers :-
  96.  
  97. Display (Submenu)       Allows the choice of window display
  98.                         types
  99.  
  100. and if menu is clicked ontop of a file then there an extra
  101. submenu titled '<FileName>' which offers the standard file
  102. operations Rename, Delete, Access and Count.
  103.  
  104.   There is a BASIC utility supplied called 'MakeTrans',
  105. this utility allows the creation of of the file
  106. 'typetrans', the data file that maps Arc filetypes onto BBC
  107. load and exec addresses. Add data lines onto the end of the
  108. data list (before the -1,-1,-1 !) if you wish to add your
  109. own mappings. 
  110.  
  111.  
  112. Versions
  113. --------
  114.  
  115. 0.00 (Beta)  Application under constant development
  116.  
  117. Comments
  118. --------
  119.  
  120. There are a great many desirable features missing from this
  121. application at the moment & the only reason I am releasing
  122. it now is because some company is selling a DFSreader for
  123. money abd I would like to give people the choice of a pd
  124. app or forking out for an expensive one.
  125.  
  126.   Even so the application is very functional and although
  127. is not as good as I would like, it is quite satisfactory
  128. for transfers.
  129.  
  130.   In future releases expect : Multi file selections,
  131. format, verify, other BBC disc formats, User default of
  132. drive, 40 track compatible, multiple windows and compact. I
  133. cannot guarantee that all these WILL be implemented but I
  134. will have a go at them!
  135.  
  136.   So please write (mail) to me with features you want and
  137. especially BBC disc format specs (ie Watford DFS) and
  138. mappings for the file 'typetrans'.
  139.  
  140.   The ChkSpr Utility
  141.  
  142.   The chkspr utility will, when run, examine the '!Sprites'
  143. file and check if the first sprite is the directory's name.
  144. If not the sprites name will be changed to the directory's
  145. name. The !Boot file contains on it's FIRST line 'Run
  146. ChkSpr', this runs the util, the next line contains
  147. 'IconSprites <Obey$Dir>.!Sprites' this loads the new sprite
  148. in. The filer always calls any new (ie renamed) app's !Boot
  149. file so the new sprite is automatically loaded for display,
  150. et volia! Please feel free to use the utility separately
  151. from the rest of the package, I think it is very useful!
  152.  
  153.  
  154. Conditions of Use
  155. -----------------
  156.  
  157.   This application is supplied free to everyone 'as is', I
  158. do not give any guarantee that it is free of bugs, or
  159. supply any warranty about its suitabliliy for use. However
  160. if there are any problems with it and you notify me of them
  161. then I probably will do my best to recify them.
  162.  
  163.   You are may give this application to anyone, via any
  164. medium, so long as :- 
  165.  
  166.   1) It is delivered with ALL the supplied files and
  167.      unaltered (except !Run & !Boot files) .
  168.  
  169.   2) It is not supplied on a disc you are charging
  170.      for (except for media and postage costs).
  171.   
  172.   You have permission to use any part or the whole
  173. application in a project you intend to place in the public
  174. domain, as long as I am fully credited. If you wish to use
  175. these routines in a program that is for sale (for however
  176. much and for whatever reasons) or released as copyright
  177. material then my express permission in writing must be
  178. obtained. I maintain copyright on all the material
  179. supplied and reserve the right to amend these conditions in
  180. cases where I deem misuse.
  181.  
  182.    A large number of hours of work have gone into the
  183. production and maintenance of this application and although
  184. I have supplied the application free, donations will be
  185. gratefully received (and if over 7 pounds I will send you a
  186. disc with updates of this and all other pd stuff I have
  187. written. Please include a letter telling me which apps of
  188. mine you use and their version number & dates).
  189.  
  190.  
  191. Contacts
  192. --------
  193.  
  194. My address:
  195.  
  196.   6 Parklands Place,
  197.   Guildford,
  198.   Surrey GU1 2PS.
  199.  
  200. BBSs I call frequently:
  201.  
  202.   Archive BBS          [0603 745932]   mbx 23
  203.   Arcade BBS           [01 654 2212]   mbx 23
  204.   The World of Cryton  [0749 679794]   mbx 273
  205.  
  206.  
  207. © Emmet Spier 1990 - USE and Enjoy!
  208.